Automatic Pix
There are 4 distinct journeys that can be made for Automatic Pix, this page will guide you through how each of them work and how to use them
Journey 1
This journey involves the beneficiary entering the payer’s information. Upon submission, the payer reviews and provides explicit authorization for the Recurring Payment Contract.
Authorization request for recurring payment
This endpoint is used to start the authorization process where the end user will receive the contract information inserted in this endpoint's body
Request
POST 'https://apisandbox.delbank.com.br/baas/api/v1/automatic-pix/authorization'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
idempotencyKey | Required. Guid |
Body
{
"id": "RR1234567820250429ABCDE122125",
"frequencyType": 1,
"startDate": "2025-05-29",
"endDate": "2025-12-01",
"amount": 150.75,
"payer": {
"ispbCode": "38224857",
"type": 0,
"document": 12345678910,
"branch": "0001",
"number": "31747"
},
"contractNumber": "CONTRATO123",
"description": "Assinatura Premium"
}
Response
The status code 200
indicates success in the query.
Being succeeded, the return will have the following fields in Json format:
{
"id":"RR0435879820240605njua7shf40o",
"requestId":"70F945C1-9024-4123-1001-A1DE2A0000D1",
"createdAt":"2025-04-13T10:10:05.025Z"
}
Answering authorization request
This endpoint allows the end-user to authorize or not a contract
Request
PUT 'https://apisandbox.delbank.com.br/baas/api/v1/automatic-pix/authorization/:identifier'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
idempotencyKey | Required. Guid |
Path Parameters:
Name | Type | Description |
---|---|---|
identifier | string | Required. Authorization identifier |
Body
{
"id":"RR0435879820240605njua7shf40o",
"authorize":true,
"payerName":"Fulano da Silva",
"payerType":0
}
Response
The status code 200
indicates success in the query.
Being succeeded, the return will have the following fields in Json format:
{
"id":"RR0435879820240605njua7shf40o",
"requestId":"70F945C1-9024-4123-1001-A1DE2A0000D1",
"createdAt":"2025-04-13T10:10:05.025Z"
}
Next step
After completing the authorization process the payer will make automatic payments on the contracts due date. Note the contract can still be cancelled at any time
Journey 2
In this journey, the payer initiates the process by scanning a QR code that contains the details of the Recurring Payment Contract. The payer then reviews and authorizes the contract directly via the QR code interaction.
Composite QR code
This endpoint is used to create a composite QR code which will serve as the recurrent payment contract
Request
POST 'https://apisandbox.delbank.com.br/baas/api/v1/qrcode/recurrent/'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
Body
{
"formatResponse": 2,
"cityName": "Sao Paulo",
"idRecorrencia": "RR3214567820250407ABC123XYZ89",
"frequencyType": 1,
"startDate": "2025-04-10",
"startDate": "2026-04-10",
"amount": "150.00",
"beneficiary": {
"ispb": 87654321,
"document": 12345678000199,
"name": "Empresa Recebedora LTDA"
},
"debtor": {
"type": 0,
"document": 62383288000188,
"name": "João da Silva"
},
"contractNumber": "CONTRATO-20250407-01",
"description": "Serviço mensal de assinatura",
"retries": 1,
"correlationId": "conciliacaoPixAuto123456789012345"
}
Response
The status code 200
indicates success in the transaction
Being succeeded, the return will have the following fields in Json format:
{
"id": "01000000-7337-ce0d-87ae-08dd9249fd05",
"imagemQRCodeInBase64": "iVBORw0KGgoAAAANSUhEUgAAAVQAAAFUAQAAAABT6fkYAAAFPUlEQVR4nO2bQXLjQAhFuQH3vyU3YPq/T8vOZio7sYgnFcvykyu4afiAJvrXj4o/9o/dx0ZERp2n87IrdXWe8+f1eYrMNrKGTf+UgIxzVVVklU5VgiXIGlZ//zl5LAvhx75joQ50HZ8DsollTerYcqw6B+cNrD0vsjay+sJZBPvIueicimZ1OpaxPSfOiuj7P46vKxLj7OY//Oxt1t7838ePffw2S1xrvnqcvhxJODwmN9Z/xcm32eMwx80xUj7EvhRP3Eu9ZmHWsETo480NWNqi2o28U3Cdm9jCdYh7jXHydiUUWaUrdXH0GlahA+fhZGtBzkEontTsTK3IGhbHEEA4IbiQC/MaG4HLb2H9JiY5/80KKLHEZJioXMPKv3UycRGWIZM1Qi45ydxYsoBNO7P8u9pCA9PSIKZd2zawRJH4bMgkEvIB16dmD+9gKwh+iKHGSiH2ndmYX/z7bLYFchExkEjtEC5kQsv1nQUsFmkFYnaiY53Umz6AUkQKdAs75+UkxDg7kQKJ5b5O19WeC1ifdwbHhrLAcP5D3j++s4IN...",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJjYWxlbmRhcmlvIjp7ImV4cGlyYWNhbyI6ODY0MDAsImNyaWFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoiLCJhcHJlc2VudGFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoifSwidmFsb3IiOnsib3JpZ2luYWwiOiIxMDAwLjAxIiwibW9kYWxpZGFkZUFsdGVyYWNhbyI6MH0sInJldmlzYW8iOjEsImRldmVkb3IiOnsiY25waiI6IjQzNTg3OTgwMDAxMDciLCJub21lIjoiQ2ljbGFubyBkZSBUYWwifSwiY2hhdmUiOiIwNTg3NjkzMjU4MiIsInR4aWQiOiJ2Y2hhcmdlNTAyNmI1MmIwM2YwNDk2ZTlhMWQ3NjEwZSI...",
"payloadJwsRecorrencia": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJl..."
}
Next step
After completing the authorization process the payer will make automatic payments on the contracts due date. Note the contract can still be cancelled at any time
Journey 3
This journey begins with the payer scanning a QR code that presents the Recurring Payment Contract. Authorization is granted implicitly through the execution of the first payment. If the initial payment is not completed, the contract is automatically cancelled.
Immediate Composite Qr code
This endpoint is used to create an immediate composite QR code which, once paid, will serve as the authorization of the recurrent payment contract
Request
POST 'https://apisandbox.delbank.com.br/baas/api/v1/qrcode/recurrent/immediate-payment'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
Body
{
"formatResponse": 0,
"key": "05876932582",
"beneficiaryName": "Fulano",
"payerText": "Pesquisa de satisfação",
"payer":
{
"document": "1234567891012",
"name": "Empresa Teste",
"type": "LEGAL",
},
"cityName": "Sao Paulo",
"zipcode": "01227-200",
"originalAmount": 1000.01,
"expiresIn": "86400",
"correlationId": "{{guid}}",
"additionalData": [
{
"name": "Detalhes do Pagamento",
"value": "Informação Adicional do PSP do Recebedor"
}
],
"reusable": false,
"contractData": {
"id": "RR0435879820240605njua7shf40o",
"frequencyType": 4,
"startDate": "2024-01-10",
"endDate": "2026-01-10",
"maxAmount": 1000,
"beneficiary": {
"ispb": 4358798,
"document": 61695227000193,
"name": "Enel89849"
},
"debtor": {
"type": 0,
"document": 4623217035,
"name": "Ciclano da Silva"
},
"contractNumber": "1234567890ABC",
"description": "Conta de energia",
"retries": 1
}
}
Response
The status code 200
indicates success in the transaction
Being succeeded, the return will have the following fields in Json format:
{
"documentId": "01000000-7337-ce0d-87ae-08dd9249fd05",
"base64": "iVBORw0KGgoAAAANSUhEUgAAAVQAAAFUAQAAAABT6fkYAAAFPUlEQVR4nO2bQXLjQAhFuQH3vyU3YPq/T8vOZio7sYgnFcvykyu4afiAJvrXj4o/9o/dx0ZERp2n87IrdXWe8+f1eYrMNrKGTf+UgIxzVVVklU5VgiXIGlZ//zl5LAvhx75joQ50HZ8DsollTerYcqw6B+cNrD0vsjay+sJZBPvIueicimZ1OpaxPSfOiuj7P46vKxLj7OY//Oxt1t7838ePffw2S1xrvnqcvhxJODwmN9Z/xcm32eMwx80xUj7EvhRP3Eu9ZmHWsETo480NWNqi2o28U3Cdm9jCdYh7jXHydiUUWaUrdXH0GlahA+fhZGtBzkEontTsTK3IGhbHEEA4IbiQC/MaG4HLb2H9JiY5/80KKLHEZJioXMPKv3UycRGWIZM1Qi45ydxYsoBNO7P8u9pCA9PSIKZd2zawRJH4bMgkEvIB16dmD+9gKwh+iKHGSiH2ndmYX/z7bLYFchExkEjtEC5kQsv1nQUsFmkFYnaiY53Umz6AUkQKdAs75+UkxDg7kQKJ5b5O19WeC1ifdwbHhrLAcP5D3j++s4INnCcU4xwCXTUFm7PqVlBb2LQKkgLSIohvrsaftD1Va+caVk5O3hs5Z7exzPC7Lqf3sEmZX0g6Eku7lKY2dfy7vZUFbKKUw5qYOokAQsHaRMIkly9ixz2onYh3aP2pnUbhrWGbil9ouRxBbzqfe6vyeg1roSGnCZpWgYgrJBx7c/xrC2tNoRWQeXzz3qEO3qi6z7q9z1oQl7uY5BhlksmDk8K79rA4uCnWg4IpJp6AuLJew8qmpIYeJ2nHEiXtm8a/89DLrKU8/W1kED9K3E6H+cN3FrA6CodrelbhRKN61d0AfuUatpwA0Rrh4n8EvntYpJavPsHbLMUTKo6yz5naGZtdqoV5+gQL2NEZ+Me4DJ9A1erJTX7V/q+znJ36351hzGyaLCzCdAW2sMp6dhx6bngKfQBGYjWjhTVsuE/FP29QN2Jreirs01rE2qlJLYrM0kXKjp5zqISKJ7dsYJWeqaDxGQv8SSk1IQY9uoWlmclwjsBNFie6RLtFkR9tv4F1bVS3fG7X+x7KMGou55otbM9wvGbGFSQUSlIn9vqqAxawlEnEEI6C2VFc+emzcfP8Ava6t0W+7JupF0/eAnlz9wLWzUAHY2dEmvAY5PHBJ/atYGlbeeYpc8L9CnwnudnDb29hGXM5PAdj0WaShNCgaMp6tNEGdu6VIByPiKcnX14bR8CnN/g+2zWTDVWoOcLN8y7WZaTyGhbz6EtQQk1/jWVBjc6tKmtYd6vIfgnvrptvVHICf2a3G9iaapo7fZh48GIkaU+C6TUslT3fvkfK7r7SYnM73lObNaybrKTAGJFEFLF6njnp0wt6n+XPt0C2ziRAu6cZvo8qntp/AdvelG5SEKEp/R2w3fnG/bewMwd1IdK+nS48+8pwByDz+R7eZwnGlBtXbSp0MKLD9dst+TWssb7jpOkSl7ejs0re3LKBjRi3dtcNP48nKIalR+xhLYR1GHZxp/F+RBwD0lzD1m2i9IwKsIb9WrNpH220ge3ZjGkFGjGjRguNZnbw6KgFrOfJNQOvrJypBz7FG9/a/n2W7E3mVpbJ6V5F9l2Z/tROG1hK/wZg3Dx9eV3EQnjr9hrWShN972rPiSWtPcsN+qc2XcDSnCKjjN6kFxi+9aeY1Hz1Vlawntn6Ijs/t0z4JsEpUTex8hWhFkGMmGlZZU3q2cS6UiKKuLHJPT9c+ZnN7GGDgEeYy/n/ME7e7mAVc/Pcw/728cf+sevYf9YBpg0XyvTXAAAAAElFTkSuQmCC",
"payloadJws": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJjYWxlbmRhcmlvIjp7ImV4cGlyYWNhbyI6ODY0MDAsImNyaWFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoiLCJhcHJlc2VudGFjYW8iOiIyMDI1LTA1LTEzVDE4OjE0OjIzLjE3NFoifSwidmFsb3IiOnsib3JpZ2luYWwiOiIxMDAwLjAxIiwibW9kYWxpZGFkZUFsdGVyYWNhbyI6MH0sInJldmlzYW8iOjEsImRldmVkb3IiOnsiY25waiI6IjQzNTg3OTgwMDAxMDciLCJub21lIjoiQ2ljbGFubyBkZSBUYWwifSwiY2hhdmUiOiIwNTg3NjkzMjU4MiIsInR4aWQiOiJ2Y2hhcmdlNTAyNmI1MmIwM2YwNDk2ZTlhMWQ3NjEwZSIsInNvbGljaXRhY2FvUGFnYWRvciI6IlBlc3F1aXNhIGRlIHNhdGlzZmHDp8OjbyIsImluZm9BZGljaW9uYWlzIjpbeyJub21lIjoiRGV0YWxoZXMgZG8gUGFnYW1lbnRvIiwidmFsb3IiOiJJbmZvcm1hw6fDo28gQWRpY2lvbmFsIGRvIFBTUCBkbyBSZWNlYmVkb3IifV0sInN0YXR1cyI6IkFUSVZBIn0.dpBOamofQSKwfHTFQNxCCcAG2UPaFu4EQkoNXjcUqV7BkhvLiC9TwbPFzCw-r6qhTHouO-F4tAh_xzmH3gC-1rR1RQ_zALoLQ8-CgnhuTtoHCXEOX3wLR8jC-YTcwxWTw82RNgfUnUtZRys2zZWM4bqnWhQiMXcjTGdo__aAUHVH1zwRQM1cV1LIfWMOits-7gupdhqSmLoDAQjr0DqEgL7lXfoRaJazTbfCFCN0v0Hc_CPHLWJycn_xhqHIADqb22-9aV0T95HxEobVFemXVBeZoGeDcXJkmjdUqhrYWQnXgLxwOKKwPfJYMJ_K9Ll1f0SaMOMZ7wZHECZgvFETug",
"payloadJwsReceurrent": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJlZG9yIjoiMTAwMC4wMCJ9LCJyZWNlYmVkb3IiOnsiY25waiI6IjU4NzY5MzI1ODIiLCJub21lIjoiQWxpc3NvbiBPbGl2ZWlyYSBOZXZlcyAiLCJpc3BiUGFydGljaXBhbnRlIjoiMzgyMjQ4NTcifSwicG9saXRpY2FSZXRlbnRhdGl2YSI6IlBFUk1JVEVfM1JfN0QiLCJhdHVhbGl6YWNhbyI6W3sic3RhdHVzIjoiQ1JJQURBIiwiZGF0YSI6IjIwMjUtMDUtMTNUMTg6MTQ6MjMuMTc0WiJ9XX0.jR6WOfYR4nQNWGYmhTyfK9PQkd03IjT4bpRDoXy1KMX2mNhpRGISAoAnLBg5IaQ8g7dm0c27TrwLJ97O9m1GLgLzmjQxYYPWyG0bs16yXkBrUH4MhmjREUgXs3bvSPLbPlWVAHPQTSCENm0CmtODF6RIE-UVWxAlqgl8WvRCFq_2N3i2LPa4r8r1W02nIC5y2S72k_BYYbmDHKlHBzR8DDqrZiqpbE7ny6N8HetGLOZpWD7gO7bRa2XKOuAv7tq6dRPRtL6woNnCdAXRoiTR_M2av2ak7bMdJ_T5aPHnlk-7RFSVRrhRxH1z8Beb-EdUMK5602hKmeiDK_rYeK-rsw"
}
Next step
After completing the payment process the payer will make automatic payments on the contracts next due date. Note the contract can still be cancelled at any time
Journey 4
In this scenario, the payer scans either a "Due Date" or a "Static" QR code format—to review the Recurring Payment Contract. Authorization is provided either by making the first payment immediately or by scheduling it. This initial payment action serves as confirmation of the payer’s authorization of the contract.
Static Composite QR code
One of the two options you can use is a static QR code. In this format the payer can make the first payment right away or schedule it thus authorizing the recurring payment contract
Request
POST 'https://apisandbox.delbank.com.br/baas/api/v1/qrcode/recurrent/static'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
Body
{
"formatResponse": 1,
"key": "05876932582",
"amount": 1100.01,
"beneficiaryName": "Fulano de Tal",
"city": "Sao Paulo",
"zipcode": "01227-200",
"correlationId": "{{guid}}",
"additionalData": [
{
"name": "Detalhes do Pagamento",
"value": "Informação Adicional do PSP do Recebedor"
}
],
"contractData": {
"id": "RR0435879820240605njua7shf40o",
"frequencyType": 4,
"startDate": "2024-01-10",
"endDate": "2026-01-10",
"maxAmount": 550,
"beneficiary": {
"ispb": 4358798,
"document": 61695227000193,
"name": "Enel"
},
"debtor": {
"type": 0,
"document": 4623217035,
"name": "Ciclano da Silva"
},
"contractNumber": "1234567890ABC",
"description": "Conta de energia",
"retries": 1
}
}
Response
The status code 200
indicates success in the transaction
Being succeeded, the return will have the following fields in Json format:
{
"payloadBase64": "MDAwMjAxMjYzMzAwMTRici5nb3YuYmNiLnBpeDAxMTEwNTg3NjkzMjU4MjUyMDQwMDAwNTMwMzk4NjU0MDcxMTAwLjAxNTgwMkJSNTkyM0FsaXNzb24gT2xpdmVpcmEgTmV2ZXMgNjAwOVNhbyBQYXVsbzYxMDkwMTIyNy0yMDA2MjI1MDUyMXZjaGFyZ2U0YmYxMGQzNzljNTU0ZjgwNzEwMDE0YnIuZ292LmJjYi5waXgyNTQ5cGl4LWguZGVsYmFuay5jb20uYnIvdjEvcmVjL3ZjaGFyZ2U0YmYxMGQzNzljNTU0ZjYzMDQyOTFB",
"payloadJwsRecorrencia": "eyJhbGciOiJQUzUxMiIsImtpZCI6IjJCQ0E4N0NCQUQyMDYwOEVGRDFCQzlCODA5QTU4RjExMEUxNUYyRTgiLCJ4NXQiOiJLOHFIeTYwZ1lJNzlHOG00Q2FXUEVRNFY4dWciLCJqa3UiOiJodHRwczovL3BpeC1oLmRlbGJhbmsuY29tLmJyL3YyL2p3a3MiLCJ0eXAiOiJKV1QifQ.eyJpZFJlYyI6IlJSMDQzNTg3OTgyMDI0MDYwNW5qdWE3c2hmNDBvIiwidmluY3VsbyI6eyJvYmpldG8iOiJDb250YSBkZSBlbmVyZ2lhIiwiZGV2ZWRvciI6eyJjcGYiOiIwNDYyMzIxNzAzNSIsImNucGoiOiIiLCJub21lIjoiQ2ljbGFubyBkYSBTaWx2YSJ9LCJjb250cmF0byI6IjEyMzQ1Njc4OTBBQkMifSwiY2FsZW5kYXJpbyI6eyJkYXRhSW5pY2lhbCI6IjIwMjQtMDEtMTAiLCJkYXRhRmluYWwiOiIyMDI2LTAxLTEwIiwicGVyaW9kaWNpZGFkZSI6IkFOVUFMIn0sInZhbG9yIjp7InZhbG9yTWluaW1vUmVjZWJlZG9yIjoiNTUwLjAwIn0sInJlY2ViZWRvciI6eyJjbnBqIjoiNTg3NjkzMjU4MiIsIm5vbWUiOiJBbGlzc29uIE9saXZlaXJhIE5ldmVzICIsImlzcGJQYXJ0aWNpcGFudGUiOiIzODIyNDg1NyJ9LCJwb2xpdGljYVJldGVudGF0aXZhIjoiUEVSTUlURV8zUl83RCIsImF0dWFsaXphY2FvIjpbeyJzdGF0dXMiOiJDUklBREEiLCJkYXRhIjoiMjAyNS0wNS0xM1QxODoyNzowOC45OThaIn1dfQ.gNyJtYD6if9spB91AT8vY__CqtOK6Yww3umwdVjKeP4SQqHdxr1hVMj0Iz5e328cjhaQA3krPcgeXRmOaS-CZyP2tUjvZ-6dpDe6KS8rWU5TNZwnI4LB2sL0dIDxT7lVE1YJ2RtcJrc_N-npnGy7x2jX4RSHNjmGi06347ufOBOV-OW_ycw3sNosFLyFIKzVl52ewT3ro4eEPvJfCkD8WKVwpypeKjvc1dwiBWm4CTQxj9soWkxcBxKD-dAppas15Ejq1aQlPA6WSsgVliC6e5W28QAy2ydxsuRnDlquxMTPbotZyp6lSZxlX7gtDmP8WTjhjX77iyJpfQyaQWeYNg"
}
Composite QR code with Due Date
The last of the two options you can use is a Dynamic Due Date QR code, allowing the use of interest, late payment fees and fines. In this format the payer can make the first payment right away or schedule it thus authorizing the recurring payment contract
Request
POST 'https://apisandbox.delbank.com.br/baas/api/v1/qrcode/recurrent/due-date'
Headers
Name | Description |
---|---|
x-delbank-api-key | Required. API key |
Body
{
"formatResponse": 1,
"key": "05876932582",
"beneficiary":
{
"name": "Fulano de Tal",
"document": 12345678910,
"type": LEGAL,
"address":
{
"street": "Rua Pix, 123",
"city": "Sao Paulo",
"uf": "SP",
"zipcode": "01227200"
},
},
"payerText": "Pesquisa de satisfação",
"payer":
{
"name": "Ciclano de Tal",
"document": "70180307000105",
}
"originalAmount": 1001.16,
"rebate": 1.11,
"discount": 0.04,
"interest": 10.15,
"fine": 200.22,
"dueDate": "2021-06-17",
"maxDaysOverdue": 365,
"correlationId": "{{guid}}",
"additionalData": [
{
"nome": "Detalhes do Pagamento",
"valor": "Informação Adicional do PSP do Recebedor"
}
],
"reusable": false,
"contractData": {
"id": "RR0435879820240605njua7shf40o",
"frequencyType": 4,
"startDate": "2024-01-10",
"endDate": "2026-01-10",
"maxAmount": 1000,
"beneficiary": {
"ispb": 4358798,
"document": 61695227000193,
"name": "Enel"
},
"debtor": {
"type": 0,
"document": 4623217035,
"name": "Ciclano da Silva"
},
"contractNumber": "1234567890ABC",
"description": "Conta de energia",
"retries": 1
}
}
Response
The status code 200
indicates success in the transaction
Being succeeded, the return will have the following fields in Json format:
{
"documentId":"52c43361-caa1-4ddb-9152-708426ª25db3",
"base64":"SkQuUElYLlFSQ29kZS5EaW5hbWljbw==……",
"payloadJws":"eyJhbGciOiJQUzUxMiIsImtpZCI6Ijg1MUI5ODdBNzEwQTk3MkM0QkIxODVFRUY4ODg1RTI4MzQzRUI1MDYi...",
"payloadJwsReceurrent":"eyJhbGciOiJQUzUxMiIsImtpZCI6IjUwQTM5Qzc0MUE0RTFDQjQxN0Y2OEM2Q0MwMkY2M0JFO..."
}
Next steps
After completing the payment process the payer will make automatic payments on the contracts next due date. Note the contract can still be cancelled at any time